메인 콘텐츠로 건너뛰기
GET
/
users
Get all users
curl --request GET \
  --url https://your_a2_service/users \
  --header 'Authorization: Bearer <token>'
[
  {
    "budget": 123,
    "campaign_count": 1,
    "creative_count": 1,
    "credit": 123,
    "email": "jsmith@example.com",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "is_active": true,
    "is_superuser": true,
    "is_verified": true,
    "name": "<string>",
    "permissions": {},
    "placement_count": 1,
    "preferences": {
      "etc": {
        "language": "ko"
      },
      "notification_methods": {
        "email": true,
        "slack": false,
        "sms": false
      },
      "notification_methods_data": {
        "slack": "<SLACK_WEBHOOK_URL>",
        "sms": ""
      },
      "notifications": {
        "attribute_deleted": true,
        "campaign_finished": true,
        "publish_approval": true,
        "publish_request": true
      }
    },
    "role": "advertiser"
  }
]

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
id
string | null
​
role
enum<string> | null

유저 역할

사용 가능한 옵션:
advertiser,
retailer,
admin

Response

Successful Response

​
budget
number
required

사용자가 현재 이용 가능한 전체 예산

​
campaign_count
integer
required

사용자가 소유한 캠페인 수

Required range: x >= 0
​
creative_count
integer
required

사용자가 소유한 소재 수

Required range: x >= 0
​
credit
number
required

사용자가 현재 이용 가능한 전체 크레딧

​
email
string<email>
required

유저 이메일

​
id
string<uuid>
required

유저 id

​
is_active
boolean
required

사용자 활성 상태 여부

​
is_superuser
boolean
required

사용자 관리자 여부

​
is_verified
boolean
required

사용자 이메일 인증 여부

​
permissions
object
required

사용자의 권한 정보

Examples:
{}
{
  "admin": [],
  "advertiser": ["permission"],
  "analytic": ["campaign"],
  "audience": [],
  "audience_attribute": ["r"],
  "audience_segment": ["r", "w"],
  "campaign": ["r", "w"],
  "creative": ["r", "w"],
  "placement": ["r"],
  "retailer": []
}
{
  "admin": ["list_advertisers", "budget"],
  "advertiser": [],
  "analytic": ["placement"],
  "audience": ["r"],
  "audience_attribute": ["r", "w"],
  "audience_segment": ["r", "w"],
  "campaign": ["r"],
  "creative": ["r", "w"],
  "placement": ["r", "w"],
  "retailer": ["approval", "permission"]
}
​
placement_count
integer
required

사용자가 소유한 지면 수

Required range: x >= 0
​
preferences
object | null
required

사용자 설정 정보

​
role
enum<string>
required

유저 역할

사용 가능한 옵션:
advertiser,
retailer,
admin
​
name
string | null

사용자 이름